home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / util / libs / MultiReq.lha / MultiReq / Documentation / Programing < prev    next >
Text File  |  1992-11-12  |  6KB  |  154 lines
  1. ###############################################################################
  2. ##                                                                           ##
  3. ##      M     M            ll     tt     ii    RRRRR                         ##
  4. ##      MM   MM            ll     tt           RR  RR                        ##
  5. ##      MMM MMM   uu  uu   ll    ttttt   ii    RR  RR    eeee     qqqqq      ##
  6. ##      MMMMMMM   uu  uu   ll     tt     ii    RRRRR    ee  ee   qq  qq      ##
  7. ##      MM M MM   uu  uu   ll     tt     ii    RR RR    eeeeee   qq  qq      ##
  8. ##      MM   MM   uu  uu   ll     tt     ii    RR  RR   ee        qqqqq      ##
  9. ##      MM   MM    uuuuu    ll     ttt    ii   RR  RR    eeee        qq      ##
  10. ##                                                                   qq      ##
  11. ##                                                                           ##
  12. ###############################################################################
  13.  
  14.  
  15. MultiReq v1.20 © 11/1992 by Andreas Krebs (released at 12-Nov-92)
  16.  
  17.  
  18. The following files and directories belong to MultiReq:
  19.  
  20.   libs
  21.     multireq.library           10700
  22.   fd
  23.     multireq_lib.fd              720
  24.   ASM
  25.     include
  26.       libraries
  27.         multireq.i                 11677
  28.         multireq_lib.i               496
  29.     SimpleDemo.asm              7967
  30.     SimpleDemo                  1180
  31.     SimpleDemo.info              454
  32.   ASM.info                     728
  33.   C
  34.     include
  35.       libraries
  36.         multireq.h                 14138
  37.         multireq_protos.h           1563
  38.     lib
  39.       mr.lib.asm                  3269
  40.       mr.lib                      2796
  41.       makefile                     171
  42.     Aztec_pragmas
  43.       multireq_lib.h               951
  44.     Lattice_pragmas
  45.       multireq_lib.h               818
  46.     SimpleDemo.c                4044
  47.     SimpleDemo                  5108
  48.     SimpleDemo.info              507
  49.     TestProg.c                  4545
  50.     TestGads.c                 11148
  51.     TestIncludes.h               595
  52.     makefile                     475
  53.   C.info                       728
  54.   Anleitung
  55.     MultiReq.dok               11724
  56.     MultiReq.dok.info            465
  57.     Library.dok                16762
  58.     Library.dok.info             465
  59.     Programmierung              5907
  60.     Programmierung.info          465
  61.   Anleitung.info               728
  62.   Documentation
  63.     MultiReq.doc               10479
  64.     MultiReq.doc.info            465
  65.     Library.doc                15437
  66.     Library.doc.info             465
  67.     Programing                  5627
  68.     Programing.info              465
  69.   Documentation.info           728
  70.   TestProg                    9652
  71.   TestProg.info                454
  72.   LiesMich                    3872
  73.   LiesMich.info                465
  74.   ReadMe                      3476
  75.   ReadMe.info                  465
  76.  
  77.  
  78. MultiReq is compatible to Kickstart 1.3 and Kickstart 2.0, whereby there's no   
  79. difference between the function and the appearance of the file requester under 
  80. the different Kickstart versions.
  81. The current version of MultiReq has only assembler and C include files, but it
  82. should be no problem to translate them into a different language. I was not able
  83. to do this, cause I don't own other languages than C and assembler.
  84.  
  85.  
  86. Installation:
  87. =============
  88. The installation of MultiReq is very simple, all you have to do is copying the
  89. "multireq.library" into the directory LIBS: and afterwards copy the include 
  90. files into your directory containing the other include files of your language.
  91. If you use C, you should also copy the corresponding pragmas-file (Aztec or 
  92. Lattice). 
  93. If you use the linker library mr.lib instead of pragmas, you should copy this 
  94. file into the corresponding directory. This file is only available in the 
  95. version smallcode, smalldata for the Aztec-C Compiler 5.2. If you need another
  96. version than you have to change the makefile in the way you like it and 
  97. afterwards recompile the linker library. 
  98. I was not able to create a linker library for the Lattice compiler, cause I 
  99. don't own it, but this should be no problem for the assembler source code of the
  100. linker library is also included.
  101.  
  102.  
  103. Starting the file requester:
  104. ============================
  105. Starting the file requester is very easy, so that the file requester can be
  106. included into any program without problems. You only have to open the 
  107. "multireq.library" to get access to all functions of MultiReq. The following
  108. example routine in C opens a file requester on the Workbench screen.
  109.  
  110. OpenFileReq()
  111. {
  112.   struct MultiReqBase *MultiReqBase;
  113.   struct FileReq *fr;
  114.  
  115.   if(!(MultiReqBase=OpenLibrary("multireq.library",0L)))
  116.     return;
  117.  
  118.   InitFileReq(&fr,2L);
  119.   if(fr)
  120.   {
  121.     FileRequester(fr,NULL);
  122.     FreeFileReq(&fr);
  123.   }
  124.  
  125.   CloseLibrary(MultiReqBase);
  126. }
  127.  
  128. As further examples the program SimpleDemo (in C and assembler) and the program
  129. TestProg (in C) are included as source code. This examples and the include files
  130. "multireq.h" resp. "multireq.i" contain all further information about the 
  131. FileReq-structure and the parameters in it. A detailed description of the 
  132. library functions is located in the file "Library.doc" and a desciption of the
  133. file requester is located in the file "MultiReq.doc".
  134.  
  135.  
  136.  
  137. If you still have questions or problems with MultiReq or simply want to mention
  138. something to MultiReq, e.g. improvements, new library functions or things like
  139. that, please write to: 
  140.  
  141. Andreas Krebs
  142. Mittelweg 9
  143. 7110 Oehringen 2
  144. Germany
  145.  
  146. Tel.: 07948/2101  (at the weekend or during holidays)
  147.       0721/821356 (any other time)
  148.  
  149. Or write to the following Email address:
  150.  
  151. Email: s_krebs@iravcl.ira.uka.de
  152.  
  153.  
  154.